home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 19.zip / BS1 part 19 / Misc I util.adf / mled.help < prev    next >
Text File  |  1988-11-01  |  23KB  |  571 lines
  1.  
  2. © Copyright C Ltd. 1988  -  Version Release 3.0
  3.  
  4.  
  5. -----------------------------------------------------------------
  6. [mlTitle]
  7.  
  8. Device Name:                     Source: Your Imagination
  9.  
  10. A DEVICE NAME is the name given to a physical or logical device.  DF0: and
  11. DF1: are DEVICE NAMES assigned to your floppy drives by Commodore and connot
  12. be changed, but DEVICE NAMES for devices that you add to the system are de-
  13. termined by you.  For example a Hard Drive partition could be called DH0: or
  14. DH: or even Betty:.  Whatever you put here is what the device will be called,
  15. it's the name that you will use to MOUNT the DEVICE and the name you will use
  16. to access the DEVICE.  WARNING: Do not attempt to confuse the GURU by giving
  17. DEVICES names that already exist.  For example you can't call a DEVICE `C:'
  18. or `SER:' or `SYS:' because these names are already used by the system.
  19. #
  20. -----------------------------------------------------------------
  21. [mlDevice]
  22.  
  23. Device:                     Source: Manufacturer's Documentation
  24.  
  25. DEVICE here refers to the file name of the device driver software provided
  26. by the device's manufacturer which the Amiga looks for in the Devs: drawer.
  27.  
  28. NOTE:  For C Ltd products running SCSIdos 2.0 to 2.6 the DEVICE name will be
  29. SCSI.device.  For C Ltd products running SCSIdos 3.0 or greater the DEVICE
  30. name will be CLtd.device.  (BEWARE the DEVICE name IS case sensative.)
  31.  
  32. #
  33. -----------------------------------------------------------------
  34. [mlFileSystem]
  35.  
  36. FileSystem:                      Source: See Text Below
  37.  
  38. Workbench 1.3 provides the new FastFileSystem for use with hard disks.
  39. If you want to use the FFS for your hard drive, make sure the file
  40. "FastFileSystem" is in the L: directory of your boot disk, and enter
  41. "L:FastFileSystem" on this line - AND - select the FFS Gadget. Note that to
  42. use FFS, you also need to format the drive with the new 1.3 format command
  43. using the FFS option.  To select the old file system, leave this line blank
  44. AND select the 'OFS' or 'NONE' (which really do the same thing as they both
  45. use the default file system) Gadget.
  46. #
  47. -----------------------------------------------------------------
  48. [mlUnit]
  49.  
  50. Unit:                              Source: See Text Below
  51.  
  52.   When you are using C Ltd's SCSIdos 3.0 then the UNIT NUMBER can be ANY
  53. value but must match the value in the UNIT entry in the UNITS section as
  54. selected (ie. See Units) below that applies to this DEVICE.
  55.  
  56. © Copyright 1988 by C Ltd.
  57. #
  58. -----------------------------------------------------------------
  59. [mlFlags]
  60.  
  61. Flags:                              Source: Manufacturer's Documentation
  62.  
  63. FLAGS are driver dependent and can represent any number of things.  Refer
  64. to the documentation for device driver for the specific device attached to
  65. this MountList entry for recommended FLAGS settings.
  66.  
  67. NOTE:  For C Ltd products running SCSIdos 3.0 FLAGS should
  68. be set to 0.
  69. #
  70. -----------------------------------------------------------------
  71. [mlSurfaces]
  72.  
  73. Surfaces:                              Source: Manufacturer's Documentation
  74.  
  75. The SURFACES value is generally used with storage devices and refers to the
  76. actual number of media surfaces on which data is stored.  Remember do not
  77. include surfaces used for sync or servo tracks in the surfaces number.  The
  78. value to be supplied as SURFACES should be found in the documentation pro-
  79. vided by the manufacturer of the storage device and may be called either
  80. recording surfaces, data surfaces or data recording heads.  Generally this
  81. value will be 2 for removable media devices, 4 for under 30 MEG Hard Drives
  82. and can be as high as 15 for some very large storage devices.
  83.  
  84. #
  85. -----------------------------------------------------------------
  86. [mlBlocksPerTrack]
  87.  
  88. BlocksPerTrack:                        Source: Manufacturer's Documentation
  89.  
  90. The BlocksPerTrack value is generally used with storage devices and refers to
  91. the actual number of 512 or 256 byte blocks (or sectors) of data that are
  92. stored on each track on one of the surfaces.  The value to be supplied as
  93. BlocksPerTrack should be found in the documentation provided by the manu-
  94. facturer of the storage device and may be called either Blocks Per Track
  95. or Sectors Per Track, but may sometimes be given as Bytes Per Track which
  96. will have to be divided by 512.  Generally the BlocksPerTrack value will be
  97. 17, 18, 25, 26, 33, 35 or 36 for Hard Drives, but may vary on other devices.
  98.  
  99. #
  100. -----------------------------------------------------------------
  101. [mlReserved]
  102.  
  103. Reserved:                              Source: Manufacturer's Documentation
  104.  
  105. RESERVED is a device dependent value and should be provided by the manu-
  106. facturer of the device driver software.
  107.  
  108. NOTE:  For C Ltd products running SCSIdos 2.0 or higher, the RESERVED value
  109. should be set to 2.
  110.  
  111.  
  112. #
  113. -----------------------------------------------------------------
  114. [mlInterleave]
  115.  
  116. Interleave:                       Source: Manufacturer's Documentation
  117.  
  118. INTERLEAVE is a device dependent value and should be provided by the manu-
  119. facturer of the device driver software.
  120.  
  121. NOTE:  For C Ltd products running SCSIdos 2.0 or higher, the INTERLEAVE value
  122. should be set to 0.
  123.  
  124.  
  125. #
  126. -----------------------------------------------------------------
  127. [mlHighCyl]
  128. [mlLowCyl]
  129.  
  130. HighCyl/LowCyl:                        Source: Manufacturer's Documentation
  131.  
  132. The High and Low cylinder values represent a range of cylinders on a storage
  133. device that are assigned to this partition.  For example, if you have a hard
  134. disk with 600 cylinders, and you want two even partitions, then the first
  135. partition would go from cylinder 0 to 299, and the second would go from
  136. cylinder 300 to cylinder 599 (meaning LowCyl=300, HighCyl=299).  The highest
  137. available cylinder should be equal to one less than the total number of
  138. cylinders as specified by the device manufacturer, but if the low-level
  139. formatting software used to format the device returns a HighCyl value (as the
  140. low level formatters supplied by C Ltd do) the value returned should be used.
  141. #
  142. -----------------------------------------------------------------
  143. [mlBuffers]
  144.  
  145. Buffers:                               Source: See Text Below
  146.  
  147. BUFFERS refers to the number of data block BUFFERS you want AmigaDOS to use
  148. as a cache for speeding up the reading speed of this device.  Generally
  149. the larger the number the better, but the larger the number, the more RAM
  150. is used as buffer memory.  Also, as the BUFFERS value gets larger, the speed
  151. improvement becomes less and less significant.  A BUFFERS value of about
  152. 32 will be sufficient for the average user.
  153.  
  154. #
  155. -----------------------------------------------------------------
  156. [mlGlobVec]
  157.  
  158. GlobeVec:                               Source: Commodore/Amiga
  159.  
  160. The GLOBEVEC value is explained in documentation provided by Commodore/Amiga
  161. with AmigaDOS 1.3.  Use the value specified therein.  (Nominally -1)
  162.  
  163. #
  164. -----------------------------------------------------------------
  165. [mlChip]
  166. [mlFast]
  167. [mlBufMemType]
  168.  
  169. BufMemType:                            Source: Commodore/Amiga
  170.  
  171. BufMemType represents the TYPE of memory that will be used for the disk cache
  172. that this device will have.  If the device is a floppy disk drive, you
  173. will NEED to have Chip RAM as buffers.  Most hard disks, including C Ltd
  174. drives, can use FAST RAM so selecting Chip would be a waste of Chip RAM.
  175.  
  176. #
  177. -----------------------------------------------------------------
  178. [mlFFS]
  179. [mlOFS]
  180. [mlNone]
  181.  
  182. FFS/OFS/None                           Source: See Text Below
  183.  
  184. Workbench 1.3 provides the new FastFileSystem for use with hard disks.
  185. If you want to use the FFS for your hard drive, make sure the file
  186. "FastFileSystem" is in the L: directory of your boot disk, and enter
  187. "L:FastFileSystem" on the `FileSystem' line - AND - select the FFS Gadget.
  188. Note that to use FFS, you also need to format the drive with the new 1.3
  189. format command using the FFS option.  To select the old file system, leave
  190. this line blank AND select the 'OFS' or 'NONE' (which really do the same
  191. thing as they both use the default file system) Gadget.
  192. #
  193. -----------------------------------------------------------------
  194. [mlStackSize]
  195.  
  196. StackSize:                             Source: Manufacturer's Documentation
  197.  
  198. This is the size of the stack that the task controlling your device
  199. will be given.  This is very dependent on the device you are using.
  200. usually 4,000 is a good value.
  201.  
  202. NOTE:  For C Ltd products running SCSIdos 2.0 or higher, the StackSize
  203. should be set to 4000 or higher.
  204.  
  205. #
  206. -----------------------------------------------------------------
  207. [mlPreAlloc]
  208.  
  209. NOTE:  For C Ltd products running SCSIdos 2.0 or higher, this
  210. field should be left blank.
  211.  
  212. #
  213. -----------------------------------------------------------------
  214. [mlHandlerName]
  215.  
  216. NOTE:  For C Ltd products running SCSIdos 2.0 or higher, this
  217. field should be left blank.
  218.  
  219. #
  220. -----------------------------------------------------------------
  221. [mlMount]
  222.  
  223. Mount:                                 Source: User Option
  224.  
  225. If this is selected (highlighted), then your device's driver will be loaded when
  226. the MOUNT command is first run, rather than waiting for the first access.
  227. This is usually a good idea, unless you would rather not have the driver
  228. for this device in RAM until it's actually needed.  (ie, for a back-up device,
  229. you might not want to automount it, but for a hard disk you would).
  230.  
  231. #
  232. -----------------------------------------------------------------
  233. [uUnitNumber]
  234.  
  235. UnitNumber:                            Source: MountList Unit Number
  236.  
  237. The value supplied here indicates that the information on this screen will
  238. be the information used to configure every device that has a MountList UNIT
  239. value that is the same as this one.
  240.  
  241. EXAMPLE:  Unit Number:  1000
  242.  
  243. #
  244. -----------------------------------------------------------------
  245. [uDriverCode]
  246.  
  247. Driver Code:                            Source: C Ltd.
  248.  
  249. This field tells the DevInstall program that the DRIVER CODE (executable
  250. program) for this UNIT is in a file called by this name.
  251.  
  252. NOTE:With SCSIdos 3.0 or higher hard drives use:  HardDisk.driver
  253. NOTE:With LazerXpress laser printers use:  LaserPrt.driver
  254.  
  255. NOTE: The file (HardDisk.driver for example) must be in DEVS: 
  256. NOTE: The filename (HardDisk.driver for example) IS case sensitive. 
  257. #
  258. -----------------------------------------------------------------
  259. [uHandlerNumber]
  260.  
  261. HandlerNumber:                         Source: User Defined
  262.  
  263. This entry tells the DevInstall program which HANDLER entry (from the list
  264. of HANDLERs) should be used with the MountList entry that is referenced
  265. by the UNIT NUMBER.  In other words, this UNIT NUMBER will talk to the
  266. SCSI Device described in the MountList `through' the HANDLER refered to
  267. by the entry provided here.
  268.  
  269. Example:  HandlerNumber:  100
  270.  
  271. #
  272. -----------------------------------------------------------------
  273. [uTaskName]
  274.  
  275. TaskName:                              Source: Your Imagination
  276.  
  277. When the TASK is running, it will be assigned the TASK NAME that you provide
  278. here.  The TASK NAME is totally up to you, but each TASK NAME must be
  279. unique.  The purpose of giving the TASK a name is so that when programs
  280. that report system status and include a list of running tasks will provide
  281. you with the name you provide here.  This allows you to better keep track
  282. of what's going on in your system.  We recommend that the TASK NAME in 
  283. some way reference this TASK.
  284.  
  285. EXAMPLE:  TaskName:  Unit_1000
  286. #
  287. -----------------------------------------------------------------
  288. [uTaskPriority]
  289.  
  290. TaskPriority:                          Source: See Text Below
  291.  
  292. This entry sets the TASK PRIORITY for the TASK for this UNIT.
  293. We recommend a value of 12.
  294.  
  295. EXAMPLE:  TaskPriority:  12
  296.  
  297. #
  298. -----------------------------------------------------------------
  299. [uStackSize]
  300.  
  301. StackSize:                             Source: C Ltd.
  302.  
  303. This entry sets the STACK SIZE that will be used with the TASK for this
  304. UNIT.  This value should be 250.
  305.  
  306. EXAMPLE:  StackSize:  250
  307.  
  308. #
  309. -----------------------------------------------------------------
  310. [uAutoRetries]
  311.  
  312. AutoRetries:                           Source: User Option
  313.  
  314. If the SCSI Device referred to by this UNIT NUMBER reports an error, this
  315. option tells the UNIT how many times it should re-try reading the data
  316. before it puts up the `Read/Write Error' error requester.
  317.  
  318. Range of legal values: 0 - 255
  319.  
  320. EXAMPLE:  AutoRetries:  4
  321.  
  322. #
  323. -----------------------------------------------------------------
  324. [uBufferSize]
  325.  
  326. BufferSize:                            Source: User Option
  327.  
  328. The value supplied here will establish the maximum size the buffer (in
  329. 512 byte increments) that can be used by this UNIT to buffer small data
  330. transfers.  The optimum value here is generally dependent on the user's
  331. applications and may be adjusted by the user to achieve the best
  332. performance.  For general applications we recommend a value of 7.
  333.  
  334. Range of legal values: 1 - 255
  335.  
  336. EXAMPLE:  BufferSize:  7
  337.  
  338. #
  339. -----------------------------------------------------------------
  340. [uUnitAddress]
  341.  
  342. UnitAddress:                           Source: See Text Below
  343.  
  344. All SCSI DEVICES have a SCSI ADDRRESS of 0 to 7.  Duplicate SCSI ADDRESSES
  345. are not allowed on the SCSI bus.  The UNIT ADDRESS here refers to the
  346. REAL SCSI ADDRESS of the physical device that is referrenced by this UNIT.
  347. Refer to the documentation supplied by the manufacturer of the SCSI device
  348. for instructions on changing the unit's SCSI ADDRESS if required.
  349. Remember, the `physical unit' is the Hard Drive itself, there can be
  350. several partitions (logical units) on one physical unit.
  351.  
  352. Range of legal values: 0 - 7       EXAMPLE:  UnitAddress:  0
  353. #
  354. -----------------------------------------------------------------
  355. [uUnit_LUN]
  356.  
  357. Unit_LUN:                              Source: Manufacturer's Documentation
  358.  
  359. Some SCSI controllers are able to control multiple devices.  For example
  360. Adaptec and Omti make SCSI controllers that can control two (and in some
  361. cases 4 or 8) ST-506 type (IBM compatable) Hard Disks.  These SCSI device
  362. controllers refer to the units they control as Logical Units and each
  363. Logical Unit is assigned a Logical Unit Number by which it is addressed.
  364.  
  365. Range of legal values: 0 - 7    EXAMPLE:  Unit_LUN:  0
  366. #
  367. -----------------------------------------------------------------
  368. [uDisable_Buffer]
  369.  
  370. Disable_Buffer:                        Source: User Option
  371.  
  372. This allows the user to disable C Ltd.'s data buffering. When `Disable' is
  373. selected (highlighted), all data will be sent directly to the memory area
  374. specified by the requesting program.
  375. Tech Note: ›mThis option is provided for custom applications software that
  376. is designed to communicate directly with the disk drive. General use
  377. of this option is discouraged.  
  378.  
  379. Gadget Status:  Normal -      Normal Buffering Is Enabled
  380.                 HighLighted - All Buffering Is Disabled
  381. #
  382. -----------------------------------------------------------------
  383. [uDisable_IRQ]
  384.  
  385. Disable_IRQ:                           Source: User Option
  386.  
  387. When Disable_IRQ is selected, all system interrupts will be held off during
  388. SCSI bus data transfer and processed when SCSI transfer is complete.  This
  389. provides Maximum SPEED at the cost of jerky mouse movements and the
  390. inability to reliably operate most telecommunications programs while
  391. Hard Disk activity is in progress.  When not selected, all operations will
  392. act normally, but some minor speed degradation (single digit percentage)
  393. may occur with some hard drives.
  394.  
  395.  
  396. -----------------------------------------------------------------
  397. [uAdaptiveBuffer]
  398.  
  399. AdaptiveBuffer:                        Source: User Option
  400.  
  401. This gadget controlls our unique and highly proprietary dynamic buffering
  402. system which optimizes buffer size to current usage.  The buffer upper
  403. limit is set by BufferSize.
  404. Disable this option to defeat the buffering, normally this option should
  405. be enabled.
  406.  
  407. Gadget Status:  Normal -      Normal Buffering Is Enabled
  408.                 HighLighted - Adaptive Buffering Is Disabled
  409.  
  410. #
  411. -----------------------------------------------------------------
  412. [uBlockRead]
  413.  
  414. BlockRead:                             Source: See Text Below
  415.  
  416. This option makes things a lot faster if `BlockRead' is enabled.  `Block-
  417. Read' works with everything we have tested EXCEPT Adaptec 4070 RLL con-
  418. trollers.  If you have an Adaptec 4070 you MUST NOT select the `BlockRead'
  419. option here.
  420. Note: The Adaptec 4000 (MFM) controller will work with `BlockRead' ON.
  421.  
  422. Gadget Status:  Normal -      Block Reads are Disabled
  423.                 HighLighted - Block Reads are Enabled
  424.  
  425. #
  426. -----------------------------------------------------------------
  427. [uWriteProtect]
  428.  
  429. WriteProtect:                          Source: User Option
  430.  
  431. When selected, the WriteProtect option allows you to software Write Protect
  432. all Logical Units using this Unit Number. 
  433.  
  434. Gadget Status:  Normal -      Write Protect is OFF
  435.                 HighLighted - Write Protect is ON
  436. #
  437. -----------------------------------------------------------------
  438. [uBlockWrite]
  439.  
  440. BlockWrite:                               Source: C Ltd.
  441.  
  442. This option is currently not implemented, do not select BlockWrite.  
  443.  
  444. Gadget Status:  Normal -      Block Write Is Disabled
  445.                 HighLighted - Block Write Is Enabled
  446.  
  447. #
  448. -----------------------------------------------------------------
  449. [uSectorSize256]
  450.  
  451. SectorSize256:                         Source: Manufacturer's Documentation
  452.  
  453. Normally not selected, this option allows you to select a SectorSize of 256
  454. byte per sector for use with devices that require 265 byte blocks like
  455. the IOmega 20 Meg Bernoulli Box.
  456.  
  457. Gadget Status:  Normal -      Sector Size Is Set To 512 Bytes/Sector
  458.                 HighLighted - Sector Size Is Set To 256 Bytes/Sector
  459.  
  460. #
  461. -----------------------------------------------------------------
  462. [hHandlerNumber]
  463.  
  464. HandlerNumber:                         Source: From UNIT 
  465.  
  466. Each C Ltd. Host/Controller connected to your system MUST have ONE AND
  467. ONLY ONE HANDLER assigned to it.  All UNITS that communicate with a
  468. specific C Ltd. Host/Controller MUST reference (by using the HANDLER
  469. NUMBER supplied here) the HANDLER assigned to that C Ltd. Host/Controller.
  470.  
  471. EXAMPLE:  Handler Number: 100
  472.  
  473. #
  474. -----------------------------------------------------------------
  475. [hHandlerCode]
  476.  
  477. HandlerCode:                           Source: C Ltd.
  478.  
  479. This field tells the DevInstall program that the HANDLER CODE (executable
  480. program) for this HANDLER is in a file called by this name.
  481.  
  482. NOTE:›m The file must be in DEVS:  
  483. NOTE:›m The FileName IS case sensitive 
  484.  
  485. EXAMPLE:  Handler Name:  SCSI.handler
  486. #
  487. -----------------------------------------------------------------
  488. [hTaskName]
  489.  
  490. TaskName:                              Source:  Your Imagination
  491.  
  492. When the TASK is running, it will be assigned the TASK NAME that you provide
  493. here.  The TASK NAME is totally up to you, but each TASK NAME must be
  494. unique.  The purpose of giving the TASK a name is so that when programs
  495. that report system status and include a list of running tasks will provide
  496. you with the name you provide here.  This allows you to better keep track
  497. of what's going on in your system.  We recommend that the TASK NAME in 
  498. some way reference this TASK.
  499.  
  500. EXAMPLE:  TaskName:  SCSI_Handler_1
  501. #
  502. -----------------------------------------------------------------
  503. [hTaskPriority]
  504.  
  505. TaskPriority:                          Source:  See Text Below
  506.  
  507. This entry sets the TASK PRIORITY for the TASK for this HANDLER.
  508.  
  509.  
  510. NOTE:›m We recommend a value of 15.
  511.  
  512. EXAMPLE:  TaskPriority:  15
  513.  
  514. #
  515. -----------------------------------------------------------------
  516. [hStackSize]
  517.  
  518. StackSize:                             Source:  C Ltd.
  519.  
  520. This entry sets the STACK SIZE that will be used with the HANDLER for this
  521. UNIT.  This value should be 250.
  522.  
  523. EXAMPLE:  StackSize:  250
  524.  
  525. #
  526. -----------------------------------------------------------------
  527. [hHostAddress]
  528.  
  529. HostAddress:                           Source: User Option
  530.  
  531. Normally in single user systems the Computer's (called a Host) SCSI ADDRESS
  532. defaults to 7, but because the C Ltd. SCSI Host/Controller can be either a
  533. Host or a Device and because C Ltd. SCSIdos does provide for more that one
  534. Computer (Host) active on the SCSI bus, the C Ltd. Host/Controller can be
  535. assigned a SCSI ADDRESS, which like any other SCSI device must be unique.
  536. In networked multi-computer systems, each Computer (Host) must have a dif-
  537. ferent SCSI ADDRESS which can not duplicate and existing device ADDRESSES.
  538.  
  539. Range of legal values: 0 - 7       EXAMPLE:  HostAddress:  7
  540. #
  541. -----------------------------------------------------------------
  542. [hArbitrate]
  543.  
  544. Arbitrate:                             Source: User Option
  545.  
  546. This attribute is intended to be used with SCSInet (Multi-Host) systems to
  547. provide full ANSI standard arbitration protocol.  ANSI arbitration protocol
  548. prevents collisions by giving the SCSI device with higher SCSI ADDRESS
  549. priority in situations where simultaneous access is requested.
  550.  
  551. NOTE:  Arbitration MUST be ON on ALL HANDLERS in Multi-Host systems! 
  552.  
  553. Gadget Status:  Normal -      Arbitration is OFF
  554.                 HighLighted - Arbitration is ON
  555. #
  556. -----------------------------------------------------------------
  557. [hDisable_IRQ]
  558.  
  559. Disable_IRQ:                           Source: User Option
  560.  
  561. Also see UNIT Disable_IRQ selection....
  562.  
  563. This option provides a global override Disable_IRQ selection for all
  564. UNITs using this HANDLER and was provided primarily for internal C Ltd.
  565. testing.
  566.  
  567. We recommend that this selection NOT be SELECTED.
  568.  
  569. #
  570. -----------------------------------------------------------------
  571.